# Cross-Compilation toolchain

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# Overview

A cross-compilation toolchain is an essential tool for compiling programs for target devices (such as ARM architecture Quectel Pi H1) on a host (such as x86_64 architecture Ubuntu). This document describes how to obtain and deploy the cross-compilation toolchain for Quectel Pi H1.

# System requirements

- **Operating system**: Ubuntu 22.04 (recommended)

- **Architecture**: x86_64

- **Disk Space**: At least 5 GB available space

# Download toolchain

## Download link

Click to download: [qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip](<https://developer.quectel.com/doc/files/qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip>)

## Toolchain information

- **Platform**: Qualcomm QCM6490

- **Architecture**: ARMv8-2a

- **Graphics system**: Wayland

- **Version**: 1.3-ver.1.1

# Deploy toolchain

## Unzip installation package

After downloading, unzip the ZIP file:

```bash
unzip qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip
```

## Execute installation script

Add executable permissions to the installation script and run it:

```bash
chmod +x qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
./qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
```

## Select installation directory

After executing the script, the system will prompt you to enter the installation directory:

- **Default directory**: Press Enter directly to use the default path

- **Custom directory**: Enter your target installation path

After installation is complete, the script will prompt you with the SDK environment activation method.

## Deployment example

```{image} images/image_UFpCb2TcDo0cZLxxLzFc6zubnAg.webp
:width: 942px
:height: 179px
```

# Use the toolchain

## Environment variable configuration

After deployment, you need to configure environment variables before use. Usually, you can activate the SDK environment with the following command:

```bash
source <installation_directory>/environment-setup-armv8-2a-qcom-linux
```

> **Tip**: Replace ``<installation_directory>`` with your actual installation path.

## Verify installation

You can verify that the toolchain is correctly installed with the following command:

```bash
$CC --version
```

If the cross-compiler version information is displayed, the toolchain has been successfully deployed.

# FAQs

## Q1: Installation script execution failed?

**Solution**:

- Ensure the script has executable permissions

- Check if disk space is sufficient

- Confirm the system version is Ubuntu 22.04

## Q2: Environment variables not effective after configuration?

**Solution**:

- Confirm that the `source` command is executed successfully

- Check if the installation directory path is correct

- Try re-executing the `source` command in a new terminal window

## Q3: How to make environment variables permanently valid?

**Solution**:

You can add the `source` command to the `~/.bashrc` file:

```bash
echo "source <installation_directory>/environment-setup-armv8-2a-qcom-linux" >> ~/.bashrc
source ~/.bashrc
```

# Next steps

After successfully deploying the cross-compilation toolchain, you can:

- Develop kernel modules

- Compile device drivers

- Build applications

For more development related information, please refer to corresponding development documents.